20-JAN-82 
SUPER-BIOS REFERENCE — El. 5 

Super-BIOS Interfa<ie Description 

Setup: ax= Super-BIOS function number 

es:bx: long pointer to parameter block 

Invoked: Software interrupt 223 

Return: As specified in function description. 

Stack and Code environment is preserved. 
Super-BIOS interface requires three words of 

caller's stack. 
DS register is preserved. 
AX.ES, and BX are reserved for return values. 

Function IJumber 

Super-BIOS Release Humber 

Returns a unique number for identifying the Super-BIOS 

release level. 

inputs: none 

outputs: ax= release number 

1 Get Zone (primarily for diagnostics use) 

Converts a track number to a zone number, 

Inputsr parmis track number (word) 
outputs: als zone number 

2 Get Sectors Per Track (primarily for diagnostics use) 

Returns the number of sectors for a specified track. 

inputs: parm1= track number (word) 
outputs: al= number of sectors 

3 Allocate Disk Job (primarily for diagnostics use) 

Returns a pointer to disk job structure. 

inputs: none 

outputs: al= error code (0= successful) 

es:bxs long pointer to job structure 

4 Start Disk Job (primarily for diagnostics use) 

Submit a job to the low-level disk driver. 

inputs: parml= long pointer to job structure 

parm2= priority (word) 
outputs: none 



5 Get Drive Information (primarily for diagnostics use) 

Return a pointer to a drive's information structure. 

inputs: parmis drive number (word) 

outputs: es:bx= long pointer to drive info structure 

6 Read Sector 

Read physical sector(s) into memory with full retries. 

inputs: parm1= drive number (word) 

parm2= track number (word) 

parm3= sector number (word) 

parmMs sector count (word) 

parra5= long pointer to memory buffer 
outputs: als floppy disk error code 

7 Write Sector 

Write physical sector(s) from memory with sector verify 
and full retries. 

inputs: parm1= drive number (word) 

parm2s track number (word) 

parm3= sector number (word) 

parm4= sector count (word) 

parra5= long pointer to memory buffer 
outputs: al= floppy disk error code . 

8 Convert Logical Sector to Physical Disk Address 

Convert an absolute sector number on disk to a track 
and sector number. 

inputs: parmls absolute sector number (word) 
parm2= long pointer to return values 
valuels track number (word) 
value2s sector number (word) 

outputs: return values set 

9 Flush Buffers 

Flush all updated buffers to disk. 

inputs: parol = drive number (word) 
outputs: al= floppy disk error code 

10 Display Disk Error 

Display BIOS error message for last disk operation. 

inputs: none 

outputs: (message displayed on screen) 

11 Get Dot Generator Address 

Returns starting address and byte count of character set 
dot memory. 

inputs: none 

outputs: es= starting paragraph of dot memory 
bx= byte count 



12 Set Dot Generator Length 

Sets byte count of character set dot memory, 

inputs:* parml= new character set byte count (word) 
outputs: al= error code (0= successful) 

13 Get Screen Address 

Return starting memory address of screen. 

inputs: none 

outputs: es= starting paragraph of screen memory 



Eh RATA SHEET 

CHANGE IH SUPER-BIOS FUHCTIOH 8 SPECIFICATIOII 

Func 8: Convert Logical Sector to Physical Disk Address 

Convert an absolute sector nuraber into its physical 
track and sector number. 

inputs: parnil= drive number (word) 

parn2= losical sector number (word) 
parm3= interleave factor (word) 

outputs: ah= track number; al= sector number 
al= FF if error 



SUPER-BIOS DISCLAIMER (A WORD OF CAUTION) 

After using the Super-Bios for awhile, we feel that the Super-Bios 
interface could be made more unified. This would involve changing 
the mechanism for returning results and error codes from the Super- 
Bios functions in a way which would allow all of the functions to 
return identically. This makes the job of accessing the Super-Bics 
much easier for applications written in high level languages, such 
as Basic or PLM. 

The functionallity of the Super-Bios will not change: only the way 
in which the functions are called and return will change. Thus ths 
Super-3ios in this release of the operating system should only be 
used to test and evaluate the Super-Bios functions. Applications 
which incorporate any Super-Bios calls will need to he (slightly) 
modified when the interface changes. 
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Super-BIOS Interface Description 

Setup: ax= Super-BIOS function number 

es:bx= long pointer to parameter block 

Invoked: Software interrupt 223 

Return: As specified in function description. ^ 
Stack and Code environment is preserveu. 
Super-BIOS interface requires three words or 

caller's stack. 
DS register is preserved. 
AX,ES, and BX are reserved for return values. 

Function Iluraber 

Super-BIOS Release Number ^.- - 4.K- c„„»». nm^ 

Returns a unique number for identifying the Super-BIOS 

release level. 

inputs: none 

outputs: ax= release number 

1 Get Zone (primarily for diagnostics use) 

Converts a track number to a zone number. 

inputs.: parm1= track number (word) 
outputs: al= zone number 

2 Get Sectors Per Track (primarily for diagnostics "se) 

Returns the number of sectors for a specified track. 

inputs: parm1= track number (word) 
outputs: al= number of sectors 

3 Allocate Disk Job (primarily for diagnostics use) 

Returns a pointer to disk job structure. 

inputs: none ^ i n 

outputs: al= error code (0= successful) 

es:bx= long pointer to job structure 

H Start Disk Job (primarily for diagnostics use) 
Submit a job to the low-level disk driver. 

inputs: parm1= long pointer- to job structure 

parm2= priority (word) 
outputs: none 



Return a pointer to a drive's information structure. 

inputs: parinl= drive number (word) 

outputs: es:bx= long pointer to drive info structure 

6 Read Sector ^„4.r.ioc 

Read physical sector(s) into nieinory with full retries. 

inputs: parml= drive number (word) 

parni2= track number (word) 

parm3= sector number (word) 

parmM= sector count (word) 

parm5= long pointer to memory buffer 
outputs: al= floppy disk error code 

^ ^ %rite%hysical sector(s) from memory with sector verify 
and full retries. 

inputs: parmlr drive- number (word) 

parm2= track number (word) 

parm3= sector number (word) 

parm^= sector count (word) 

parm5= long pointer to memory buffer 
outputs: al= floppy disk error code 

8 Convert Logical Sector to Physical Disk Address 

Convert an absolute sector number on disk to a tracK 
and sector number. 

inputs: parml= absolute sector number (word) 
parra2= long pointer to return values 
value1= track number (word) 
value2= sector number (word) 

outputs: return values set 

9 Flush Buffers 

Flush all updated buffers to disk. 

inputs: parm1= drive number (word) 
outputs: air floppy disk error code 

10 Display Disk Error . . 

Display BIOS error message for last disk operation. 

inputs: none 

outputs: (message displayed on screen) 

11 Get Dot Generator Address ^ , v. «4.„^ ^«4. 

Returns starting address and byte count of character set 

dot memory. 

inputs: none ^ . ^ 

outputs: es= starting paragraph of dot memory 
bx= byte count 



inputs: parn,l= new character s.l byte count iworu, 
outputs: al= error code (0= successful) 

'' ''' 'SetrrnTtarUng ..e.ory address of screen. 

ou?pi?i: «"%tartins paragraph of screen ™en,ory 
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Super-BIOS Interfa ce Description 

Calls to the Super-BIOS are made by loading the AX register with 
a function number and then doing a software interrupt (level 
223). All parameters/results are passed to/from the Super-BIOS 
junctions via a parameter block supplied by the caller. The 
parameter block is pointed to by a long oointer set by the caller 
m tne -ESrBX registers. The Super-BIOS function returns with an 
exception condition in the AX register: a zero value indicates 
that tne function was succesfully completed. 

The contents of the CX,DX,SI,DI and BP and flag registers return 
undefined. The Super-BIOS interface requires 3 words of the 
caller's stack. 



Setup: ax= function number 

es:bx= pointer to the parameter block 

Call: INT 223 

Return: ax= exception code 

return values set inparameter block 



Super BIOS Fun c tions 

^ Function 0: Version Number 

Returns a unique number used for identifing the release 
of the operating system. 

parml: version number (word/output) 

Function 1: Get Zone (for diagnostic use) 

Converts a track number into its zone on the disk. 

parml: track number (word/input) 
parm2: zone (word/output) 
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Function 2: Get Sectors On Track (for diagnostic use) 

Returns the number of sectors on the specified track 

parml: track number (word/input) 
parra2: number of sectors (word/output) 

Function 3: Allocate Disk Job (for diagnostic use) 

Returns a pointer to a disk job structure, 
parml: job structure ptr (long pointer/output) 



Function 4: Start Disk Job (for diagnostic use) 

Submit a job to the low-level floppy disk driver. 



parml: job structure ptr 
parm2: priority 



(long pointer/input) 
(word/input) 



Function 5: Get Drive Information (for diagnostic use) 

Return a pointer to the specified driveVs information 
structure. 



parml: drive number 
parm2: DI structure ptr 



(word/input) 

(long pointer/output) 



Function 6: 



Read Sector 



Read physical sector (s) into memory buffer. Full 
retries are performed. 



parml: drive number 

parm2: track number 

parm3: sector number 

parm4: sector count 

parmS: buffer address 



(word/input) 
(word/input) 
(word/input) 
(word/input) 
(long pointer/input) 



Function 7: Write Sector 

Write physical sector (s) from memory buffer. Full 
retries are performed. 



parml: drive number 

parm2: track number 

parmS: sector number 

parm4: sector count 

parmS: buffer address 



(word/input) 
(word/input) 
(word/input) 
(word/input) 
(long pointer/input) 
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Function 8: Logical to Physical Disk Address 

Convert an logical sector number into a physical track 
and sector number. 

parml: drive number (word/input) 

parin2: logical sector (word/input) 

parm3: interleave factor (word/input) 

parra4: track number (word/output) 

parraS: sector number (word/output) 

Function 9: Flush Disk Buffer 

Flush any updated ("dirty") disk buffers, 
parml: drive number (word/input) 

Function 10: Display Disk Error Message 

Display the disk error message for the last disk 
operation. 

@ Function 11: Get Character Generator 

Returns the length and the starting address of the 
character generator dots in memory. 

parml: byte count (word/output) 

parm2: base addr of dots (word/output) 

@ Function 12: Set Character Generator Size 

Set the size of the character generator, 
parml: byte count (word/input) 

(5y Function 13: Get Screen Address 

Return the location' of screen memory, 
parml: base of screen (word/output) 
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Function 14: Get Device Vector 

Get the current vector for the specified device driver 

parml: device number (word/input) 

parm2: device vector (long pointer/output) 

Function 15: Set Device Vector 

Set the vector for the specified device driver. 

parml: device number (word/input) 

parm2: device vector (long pointer/input) 



Se(^ ^^ covj^revv'V i/evsfo-in. «=>t ^lsC>os 
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Disp>l8y Driver Spec I f icstion 



A2-1 Introduction 

The software in the Sirius developed BIOS display interface 
receives ASCII characters and either dispilays them or uses 
thew for display control- Characters in the ASCII control 
set (hex 00 through hex IF and hex 7F) Br& used as control 
characters and are not dispilayed (see "ESC 8" excepition 
below.) However, they may affect the display. Most of the 
control characters act by themselves. However, for some 
action more than one character is required to specify the 
action. This is accomplished by using the ASCII esc apie code 
(ESC — hex IB) followed by one or more characters- The 
control characters and the escapie sequences are described 
below. 
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A2.2 Control Characters 



Bell (Ctrl 6, hex 07) 



This is not really a 
display control character. 
It sends, to the CODEC a 
series of signals to make 
the sound of a bell. 



Backspace (ctrl H, hex 08) 



Positions the cursor back 
one column. If at column 
1, then position cursor at 
column 80 of p<revious row; 
unless at columnm 1, row 1 
in which esse prosit ion to 
column 80, row 1. 



Horizontal Tab (ctrl I, hex 09) 



Positions the cursor on 
the next tab stop. Tab 
stofis artit fixed and ar^ at 
columns 9, 17, 25, 33, 41, 
49, 57, 65, and 72 through 
80- If the cursor is at 
column 80, it remains 
there. 



Line Feed (ctrl J, hex 0A> 



Positions the cursor down 
one row. If at row 24, 
then scroll display up 1 
row. (Mag also be treated 
as a carriage return — 
see ESC x9.\) 



Carriage Return (ctrl (1, hex 00) 



Positions the cursor at 
column 1 of the current 
row. (May also be treated 
as 3 line feed — see 
ESC x8.) 



Shift In (Ctrl N, hex OE) 



Shift to display character 
set 1 (tU). 



Shift Out(ctrl 0,hex OF) 



Shift to display character 
set (60). 
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A 15 -2 Escape Sequences 



Escape 
Sequence/Funct I on 



ASCII Code 
Generated 
(Hexadecimal) 



.Sequence_Def I n 1 1 i on 



CURSOR FUNCTIONS 




Esc A 


IB, 41 


Esc B 


IB, 42 


Esc C 


IB, 43 


Esc D 


IB, 44 


Esc H 


IB, 48 


Esc I 


IB, 49 


Esc n 


IB, 6E 


tsc j 


IB, 6A 


fesc k 


IB, 6B 


Fsc YtlDCcD 


IB, 59 



Moves the cursor up one line 

Moves the cursor down one 
line without changing columns. 

Moves the cursor forward 
one character position. 

Moves the cursor backward one 
character position. 

Sets the cursor at home position 

Moves the cursor to the sane 
horizontal position on tne 
preceding line. 

Reports the cursor position. 

The display driver saves tie 
cursor position. 

Returns the cursor to tie 
previously saved cursor posit on. 

Moves the cursor via dirert 
cursor addressing, where ':' 
represents the hexadecimal I iie 
number and 'c' represents tie 
hexadecimal column number. Tie 
first line and the left coluin 
are both 20 (hex) (the smallest 

the pr i nt i rg 

and increase frtm 

the I i nes are 

1 to 19 (he?) 



value of 
characters) 
there. Since 
numbered from 



(from top to bottom) and ti-e 
columns from 1 to 50 (hej) 
(from left to right), you must 
add the proper line and coluin 
numbers to IF. No movement is 
done, if i and/or c are invalid 
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Escspe Sequi=!nce& (cont inu^sd) 



ASCII Code 
Escspie Generated 

ijequence/Fwnct Ion (He^sdec imsl) 



EDITING FUNCTIONS 
Esc E 
Esc b 

hsc J 

Esc I 
tsc o 

Esc K 
Esc L 



tsc M 



tsc N 



tsc e 



tsc 



IB, 45 
IB, 62 

IB; 4A 

IB, 6C 
IB, 6F 

IB, 4B 
IB, 4C 



IB, 4D 



IB, 4E 



IB, 40 



IB, 4F 



.Sequence_Def I n 1 1 i on. 



Erases the entire screen- 

Erases from the start of tie 
screen upi to and Including tie 
cursor p>osition. 

Erases fro»« the cursor p'osititn 
to the end of the page. 



Erases entire line. 

Erases the beginning of 
line up to and including 
cursor piosltion. 



tie 
tie 



Erases froM the cursor positim 
to the end of the line. 

Inserts a blanli line; the cur- 
rent line and all followitg 
lines are moved down one lin«« 
The cursor Is moved to tie 
beginning of the blank line. 



Deletes 



the 



current 



lint 



placing the cursor at the start 
of the line, and moves a I 
following lines up one line. A 
blank line is inserted at lite 
24. 

Deletes cursor-p«osl t Ion char- 
acter and shifts the rest cf 
the line one character positim 
to the left- 

Enters the Insert character 
mode, allowing insert into te:t 
on the screen. As each nnj 
character is inserted, tie 
character at the end of tie 
line is lost. 

Exits from the insert charactn- 
mode. 
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Esc8p*«! Sequences (continued) 



A9CII Code 
Escape Generated 

Sequence/Function (Hexadecimal) 



^Sequence^De-f i n i t i on. 



CONFIGURATION FUNCTIONS 

Esc xCPs3 IB, 78 



Sets frtode(s) as follows: 



Ps 

1 

3 

4 
5 
8 



A 
B 
C 



Mode 

Enable 25th TTne 

Hold Screen mode on 

Block cursor 

Cursor off 

Auto line feed on receiyt 

of 3 carriage return 

Auto carriage return or 

receipt of a line feed 

Increase audio volume 

Increase CRT brightness 

Increase CRT contrast 



Esc yCPsl 



IB, 79 



Esc ^ 
Esc C 
Esc \ 
Esc i 



IB, 5E 

IB, SB 

IB, 5C 

IB, 7C 



Resets mode(s) as follows? 

Ps _ Mode 

1 Disable 25th iTne 

3 Hold screen mode off 

4 Underscore cursor 

5 Cursor on 

8 No auto line feed 

9 No auto carriage return 
A Decrease audio volume 

B Decrease CRT brightness 
C Decrease CRT contrast 

Toggle hold mode 
Set hold mode 
Clear hold mode 
Activate User defined 
console (T.B.A.) 



OPERATION MODE FUNCTIONS 

Esc p IB, 70 

Esc q 18, 71 



Enters the reverse video mode. 
Exits the reverse video mode. 
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Escape Sequences (continued) 



ASCII Code 
Escapie Genera-bed 

i>equence/Funci i on (Hexadec i mal ) 



Sequence_Def I n 1 1 i on. 



SPECK 


^L FUNCTIONS 




Esc 


> 


IB, 7D 


Esc 


< 


IB, 7B 


tsc 


V 


IB, 76 


Ksc 


w 


IB, 77 


tsc 


z 


IB, 7A 


Esc 


♦ 


IB, 24 


Esc 


3 


IB, 5D 


Lsc 


tt 


IB, 23 


Esc 


( 


IB, 28 


tsc 


> 


IB, 29 


Esc 


+ 


IB, 2B 



tsc Z 

Esc 
tsc 1 
Esc 2 
tsc 3 
Esc 8 



IB, 5A 

IB, 30 

IB, 31 

IB, 32 

IB, 33 

IB, 38 



Disables the keyboard. 

Enables the keyboard. 

Enables wrap around at the end 
of the line. 

Disables wrap around at the erd 
of the line. 

Resets .terminal to power-cn 
conf iQuration- 
Transwits the character at 
the cursor. 

Transmits the 25th line. 

Transmits the page. 

Sets h i gh i ntens i ty . 

Sets low intensity. 

Clears the foreground. 
(High intensity displayed 
characters) 

Identifies display as emulatirg 
VT52 (the terminal responds 
with an ESC \ K). 

Sets the underline mode. 

Resets the underline mode. 

Enables cursor blink- 

Di sables cursor blink. 

Sets the test (literally) mods 
for the next single 
character. 
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Escspie Sequences (continued) 



Esc3pie 
Sequence/Funct i on 



ASCII Code 
Generated 
(Hexsdec imal) 



.Sequence_Def i n 1 1 1 on. 



Esc iZnl 



IB, 69 



Displays tine systern disl'.et-ie 
sign-on banner, as follows! Cn 
represents tine ASCII numeric 
cliaracter) 

n Display 

Tlie entire bBnn&rm 

« 

1 Tine coAipany logo only. 

2 Tine product name only. 

3 Configuration 
information only. 
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A A. 2 Compart «>on Summsry 



Cursor 


Functions 


Sirius/ 


DtC 


Heathlit 




Cusor upi 


__Victor 


vr52 


H1V_ 


HSC A 


X 


X 


>. 


ESC B 


Cusor down 


X 


X 


>c 


tsc C 


Cusor forward 


X 


X 


>; 


ESC D 


(BS 08H) Cusor back 


X 


X 


y 


tsc H 


Home 


X 


X 


>t 


TAB (09H> Tab 


X 


X 


>; 


LF COAH) Line Feed 


X 


X 


>; 


CR (ODH) Carriage Return 


X 


X 


>; 


KSC I 


RVS Line Feed 


X 


X 


y. 


ESC Y 


Address Cursor 


• X 


X 


y 


tsc n 


Report Cursor 


X 




y 


ESC k 


Restre Cursor 


X 




y 


tsc j 


Save Cursor 


X 




y 


tditing Functions 








tsc J 


Erase EOS 


X 


X 


y 


ESC K 


Erase EOL 


X 


X 


> 


tsc b 


Erase SOS 


X 




> 


ESC 1 


Erase Line 


X 




> 


tsc o 


Erase SOL 


X 




> 


ESC E 


Erase Screen 


X 






tsc L 


Insert Line 


X 






ESC n 


Delete Line 


X 




> 


tsc e 


Insert flode 


X 




i 


ESC 


Exit Insert Mode 


X 




• 


tsc N 


Delete Char 


X 


\ 


> 


Special Functions 








tsc F 


Graplnics Mode On 


X 


X 


: 


ESC G 


Graphics Mode Off 


X 


X 




tsc = 


ALT- Keypad on 




X 




ESC > 


ALT- Keypad off 




X 




tsc % 


Hold mode on 


X 


X 




ESC / 


Hold mode off 


X 


X 




tsc C 


Transmit 25th line 


X 






ESC M 


Transmit Page 


X 






Bell 


<07H) 


X 


X 




<13H) 


(IIH) Xon Xoff protocol 




X 




(0OH> 


<7FH) NIJL DEL Ignored 


X 


X 




ESC < 


Enable Keyboard 


X 






tsc > 


Disable 


X 






ESC + 


Clear Foreground 


X 






tsc 8 


Test Mode 


X 






ESC V 


Enable Wrap 


X 




• 


tsc w 


Disable Wrap 


X 




■: 


ESC p 


Reverse ON 


X 




i 



l> I spl ay Dr I ver Sp^ec i f I c at I on 
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(Comparison Surnmsry Continued) 

S i r i us/ DEC Hesthk i t 
V i ctor VT52 H19 



hSC q 


Reverse OFF 


X 


ESC < 


High Intensity ON 


X 


hSC > 


High Intensity OFF 


X 


ESC 


Underline ON 


X 


tSC 1 


Underl ine OFF 


X 


ESC 2 


Blink Cursor ON 


X 


kSC 3 


Bl i nk Cursor OFF 


X 


ESC 4 


Set Key Function 


X 


bSC i 


Display system information 


X 


ESC z 


Reset 


X 


fcSC Z 


Identify as VT52 


X 


ESC 


Enter ASCII mode 




tsc t 


Enter keypad sliift mode 




ESC u 


Exit keypad shift mode 





Set Reset Modes 

tsc x/y 1 25th line x 

ESC x/y 2 Key Click 

tsc x/y 3 Hold Screen x 

ESC x/y A Block Cursor x 

tsc x/y 5 Cursor Display x 

ESC x/y 6 Kpd Shifted 

tsc x/y 7 Alt Keypad 

ESC x/y 8 Auto LF x 

tsc x/y 9 Auto CR x 

ESC x/y A Volume Increase/Decrease x 

tsc x/y B Brightness " " x 

ESC x/y C Contrast " " x 
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Design notes on ^'eaio display 
c»nd l:eyboar d testing 



-ursor - The VT52 usee a blinking underscore. The Z19 uses a blinking 

bo>!. The Sirius uses a nonbl inking bo>j. The Sirius and Z19 ca' 
change the cursor type to several forms. 

Repeat - The VT52 describes the rate of repetition may attain 30 cps but 
key no -futher characteristics are known. The Z19 describes the rate 

of repetition at 15 cps but no futher characters are are described. 

The Sirius repeat key will not start repetition for 1/2 second tren 

reptition occures at 20 cps. 

Cursor - The VT52 cursor moves to the right one position after each display- 
move- able character is typed until the 80th column is reached. The cursor 
ment will not move past the 80th column and each succeeding character over 
writes the preceeding one with the cursor over the character. Ti-e 
Z19 uses wrap around on start-up but can be changed to emulate the 
VT52. The Sirius emulates the Z19. 

Return - The VT52, Z19 and Sirius perform this action identically. The 
key cursor is move the 1st column without changing lines. However 

the Z19 and Sirius have addational Escape sequences to alter this 
action. The control code M <'^M, ODH) causes the identical actior. 

Line — The cursor is moved down one line (row) without changing columrs. 

feed upward scrolling occures if the cursor is at line 24. Scrolling 

causes line 1 to be replaced by line 2 and line 2 to be replaced by 
line 3 ect. ect. until line 24 is replaced with 80 spaces and the 
cursor placed in the column determined by the action that cuased the 
scrolling. In this case the cursor does not change columns. The 
control code J C^J, OAH) causes the identical action. 

Tab - The cursor moves to the right at least one column, and continues 
key moving right until it reaches a horizontal TAB stop. It stays or the 
-same line. The TAB stops are fixed in columns 9, 17, 33, 41, 49. 57, 
65, and 73. If the cursor was at TAB stop to begin with, it moves 
rightward to the next TAB stop. If the cursor was in columns 73 - 79 
it simply moves rightward one column until it reaches column 80, it 
will not move past the 80th column. The control code I <'^I, 09H 
causes the identical action. 

Back - The cursor is moved on coluumn to the left. (If the cursor wa^ at 
space the start of a line, it will not go past the first column.) No 
key characters are replaced. The control code H C^H, 08H) causes the 
identical action. 

Shift - The ASCII characters in the code range 61H to 7AH (a-z) are 
lock converted the upper case only when this key is pressed. Pressinj 
key this key again reverses the shifting action so that these characters 

can be .type in both lower and upper case depending on the pressiig of 

the shift keys. No code is generated. 

JIfe* 1 - The control code 6 C^G ,07H) causes a tone sound. There are ra 

futher specifications described for the VT52. The Z19 describes the 
frequency of the bell at 1000 Hz for 200 milliseconds. 

- The VT52 and Z19 both use the audio to output a 'click' as eaci key 
is pressed. The Z19 describes the 'click' as the same 1000 Hz tzne 

Lai 't-h a rliir-ai-inri rt-f ^i « mi 1 1 i cifar-nnrle;. Thp»r-*a 1 «5 no desrr-intion -far th* 



CcNfiCC? 



.'O. 



25th - The 25th line is considered e. seperate 1 line terminal disple- 
line seperate -forni the -first 24 lines on the screen. The 25th line Csn be 
enabled or disabled allowing or disallowing operations to take p. ace 
there. All the operations available -for the -fisrt 24 line also xpei — 
ate on the 25th line. However some operations will display no artion 
due to the screen being limited to 1 line. 



* Note: VT52 compatible escape sequences 
Note: VT52 escape sequence actions; 

When a VT50 series terminal receives ESC, it will interpret 
rather than display the ne>:t displayablek,Cbafhacter. This displaable 
character should directly follow ESC. It is known as 
character' of the Escape Sequence. If a control 
terminal between the ESC and the final 
fied by the control code is performed 

received, and the function specified by the Escape Sequence is pa — 
formed when the final character is received. 



the 'final 
a control code is sent to the 
character, the function s;eci- 
when the control code is 



note: The above is quoted from the DECscope User's Manual, pg. Iz 
The Z19 does not describe Escape sequence action. My experi 
ence shows that Zenith follows the DECscope description. 



St.^. 



Hey, code 



ESCAPE SEQUENCES 

Sequence Defi nation and test notes 



*Esc H 1BH,4SH 



The cursor is moved to the HOME position - the 
character position at the upper left corner of tie 
screen, (row 1, column 1).. Esc H works from the 25th 
line and is not affected by the status of the 25rh 
line. 



»Esc C 1BH,43H 



Test: the screen should be cleared then the cursir 
should be place in some position on the screen ard 
then "HOME"ed then a character printed in the HO*E 
position and the cursor "HOME"ed again the procesdure 
is repeated from the positioning of the cursor urtil 
all positions on the screen are tested. A successful 
test will have one character in the HOME positior. 

The cursor is moved one column to the right. Th» 
cursor will not move past the 80th column. This 
escape sequence is not affected the wrap around -lag. 
This has the identical action on the 25th line i- the 
25th line is enabled. 



3 



Test: The screen should be cleared and the cursor 
"HOME"ed. Each row should be labeled 1-9, and A-L 
The cursor should be place on a row then moved r_ght 
by the sequence move than 80 times and the proems 
repeated until all 24 lines are tested. A sucessHil 
test will not affect the row numbering or cause 
scrolling. 



*Esc D 1BH.44H 



The cursor i^ mrw/^ri nn«a i-olumn 4-<-> *h< 



»^-i- 



TK. 



A I < t- J - 



Tu = t: Sc-..ii-: i>s Esc C te=t • e;:cc-pt Ine cursor is 
ple-ced ot the 80th column. 

Esc B 1BH,42H The cursor is moved down one row without changirc 

columns. The sequence will not cause the cursor lo 
move past the 24th row. Another words no scroli.-g 
will occure. This has no action on the 25th lire. 

Test: The screen should be cleared. A character zs 
printed on row 1 o-f some column and the cursor noed 
over this character. The escape sequence is repsstec 
until all columns on row 1 are -filled with the cr.ai — 
acter and then repeated several more times. A 
sucessful test will leave the top row intact not 
causing scrolling. 

♦Esc A 1BH,41H The cursor is moved up one row without changing 

columns. The sequence will not cause the cursor -o 
move past the 1st row. That is, no reverse scrci'.ing 
should occure. This has no action on the 2Sth J:-e. 

Test; Same as above but the characters are place: in 
the 24th row. A sucessful test will leave the tcrton 
row intact not causing scrolling. 

*Esc I 1^H,49H Causes the same action as Esc A except causing 

reverse scrolling to occure. If the cursor is ir the 
25th line the line should be cleared. However 2- the 
Z19 no action odccures. 

Test: Five rows of characters should be placed zr 
rows 19—24, the cursor moved to some column on ztb 
24th row the escape sequence is repeated 28 tines. 
This proceedure is repeated until all 80 columns nave 
been tested. A sucessful test will leave only ire 
line of characters on the 24th row. 

*Esc YC13Cc3 'The cursor is directly moved to the row CID and -ne 

lBH,59H,lH,cH column CcD. The CI 3 and Cc3 codes are formed as 

Hex i decimal numbers. To avoid conflict with the 
first 32 ASCII control characters, an offset of :FH 
must be added to the desired row and column numa-s. 
Example: to position cursor at row lO and columi 20, 
lOD (decimal) = OAH and 20D = 14H. The final cos is 
CI 3 <= 20H = OAH + IFH and CcD <= 33H = 14H + l-r. 

Test: The screen should be cleared. Several 
sentences could be printed by alternating direcr 
cursor positioning of each character with a ranizm 
positioning of the cursor. A sucessful test wculd 
print the sentences correctly without causing sr 
other video event from occuring. 

* Special note: the Z19 executes the CI 3 and Cc3 s 
soon as they are received. If the line is out or 
range the cursor will not change lines while tte 
cursor will move to the proper column. If thezilumr 
is out of range, the cursor will move to the prraer 
1 4 ncm z>nH nnf-n i-i-iiiimn RO . If both line and coluTT arf 



the end of the page are ch.r^PQed to spc^ces, H \-s 
cursor is on the 25th line, the Esc J is the So.-i as 
Esc K and has the identical action as on any lir.;. 



*Esc K 1BH,4BH 



Test: The screen should be filled randomly with c.-jar — 
aracterSj, the cursor should be place randomly on ^he 
screen and a sentence printed pointing out that sll 
characters following it should become spaces. Tris 
proceedure should be repeated say 20 times with thB 
cursor being placed at least at the home positior and 
the 24th row and 80th column. A sucessful test "ill 
leave the screen with no characters following ths 
cursor position. 

All characters for the current cursor position tc the 
end of the current line are replaced with spaces. 
This has identical effect if the cursor is on ths 
25th line. 



*Esc Z 1BH,5AH 



Test: The screen is filled with some character. The 
cursor is "HOME"ed. The escape sequence is eaecuzsd 
for each line while the cursor is in column I, tre 
line is refilled with the characters and the nexr 
line is tested with the escape sequence until all 24 
lines are cleared and replaced. A sucessful tesr 
will cause a blank line to move down the screen 
leaving the screen filled with characters. 

This sequence causes the display to respond with an 
escape /A<VT50) or /H(VTSOH) or /K(VT52) or /C(V-35) 
or /J<VT50H with copier) or /L<VT52 with copier). 

Tests The escape sequence will cause the Sirius 
system to print on the screen '*'CK. 



Z19 ESCAPE SEQUENCES 



Esc n .1BH,.4EH 



Reports the cursor position to the video display 
screen as characters formed from the Hex code 
position. This acts identical if the cursor is m 
the 25th line. 



Test: Print a message describing where the curso' 
will be positioned in hex. Move the cursor there 
execute an Esc j then move back to the message t^en 
execute the Esc n sequence. A sucessful test will 
leave matching cursor code positions. What happa-ts 
when the cursor is moved off screen then the Esc n 
executed? 



Esc j 1BH,6AH 



Save the cursor position in the BIOS display 

driver. This acts indentical if the cursor is or the 

25th line. 



Tests Move the cursor randomly to some position. 
Excute the sequence then print a pointer to the 
position then move the cursor to several other 
positions then ask the cursor to be moved back Lsing 
then Esc k sequence. This proceedure would be reieat— 
ed 20 times each time leaving a special character 
where the cursor was moved back to. 



Te&t: Print several sentt?ncG»s, one character si a 
time. The character is printed, the cursor is Si-.-e'd 
by the Esc j sequence, the cursor is moved to sir.e 
other position (sometimes of-f page), the cursor :s 
restored via the Esc k sequence;, and the proceeaire 
repeats until all the characters o-f the sentences 
&re printed. A sucessful test will, print readat.e 
sentences. 



Esc E 1BH,45H 



Esc b 1BH,62H 



Erases all the characters on the screen. The sc-een 
is -filled with spaces (20H) and the cursor is placed 
in the home position. I-f the cursor is on the 3th 
line, the 25th line should be cleared and the cu-sor 
put in column 1, However the Z19 clears the screen 
but leaves the cursor position unchanged. % 

Tests The screen should be completely -filled witi 
displayable characters. A message should be output 
e>:plaining the the screen will be cleared with eiough 
delay to see the message then the Esc E executed. 
A sucess-ful test will leave the cursor in the hc-,e 
position and no displayable characters on the sceen. 

Erases the display -from the start o-f the screen no 
and including the cursor position leaving the cu-sor 
position unchanged. This is not a-f-fected by wraj 
around mode. This acts identically if the curso- is 
on the 25th line. 



Esc 1 -1BH,"6GH 



Test: The screen is -filled to some random position in 
the screen, a message is output describing the tist, 
a delay is set so that the messages can be read, and 
the Esc b is executed. A sucess-ful test will cisar 
the screen up to the cursor without af-fecting an- 
other portion o-f the screen. 

Erases the entire line, including the cursor position 
the cursor position remains unchanged. This is Tot 
af-fected by wrap around mode. This acts identically 
if the cursor is on the 25th line. 



Esc o 1BH,6FH 



) 



Esc L 1BH,4CH 



Tests Three rows of characters are printed. An irr ow 
is* positioned to point to where the cursor is tc be. 
The cursor is moved to the middle row and the Esr 1 
executed. A sucessful test will clear the middl* row 
only and leave the cursor where the arrow is poirting 

Erases from the beginning of the line 'to and incud- 
ing the cursor position. The cursor position retains 
unchanged. This is not affected by wrap around Tode. 
This acts identically if the cursor is on the 25ni 
line. 

Tests Same test as above. A sucessful test will leave 
the cursor position unchanged with all characters to 
left of the cursor to the beginning of the line 
cleared. 

Inserts a new blank line by moving the line that the 
cursor is on, and all the following lines, down me 



. U< i Ullill I 



rn_ii^tivt?r tne ^ir* -5i:es rnis rzv.— 



ion a-ftsr it splits the ]ine -from the right o^ t-£ 
cursor position 2 characters and places the le+t 
portion on row one right justi-fied and it places zhk 
right portion on row 2 left justi-fied. 



Esc M 1BH,4DH 



Test: Three lines of characters are printed togeiner, 
then two lines of text should be printed on rows 23 
and 24, The 23d row line describes that it will re- 
main while the 24th row will explain it will be 
scrolled off. A delay is set to allow the readirg of 
of the last to sentences and the Esc L executed. 
A sucessful test will clear a line where the cuscr 
was leaving the cursor in column one and only 23c 
line now on the 24th row. 

Deletes the contents of the line the cursor is cli — 
rently on moving the cursor to column 1 and movirg 
all following lines up one row adding a blank lire 
on row 24. This is not affected by wrap around 
mode. If the cursor is on the 25th line the should 
effectively be cleared. However on the Z19 takes 
some portion of row 1 and the remaining columns sre 
taken from row 2 the combine 80 characters are plt on 
line 25. 



Esc N 1BH,4EH 



Test: Three lines of text are printed on three con- 
secutive rows. The remaining rows below are filled 
with characters. The cursor is move some place en 
the middle line. The Esc M is executed. A sucessful 
test will delete the line the cursor was on and the 
following lines moved up one row with row 24 filled 
with spaces. 

Deletes the character at the cursor position and 
shifts all the following characters on that line one 
column to the left while adding a space at columr 80. 
Only the current line that the cursor is on is 
affected. This sequence is not affected by the w-ap 
around mode. If the cursor is on the 25th line the 
action is identical. 



Esc 9 1BH,40H 



Test: Three lines of text are printed on three con- 
secutive rows. The cursor is move to some columr on 
the middle line and the Esc N is repeated more tran 
the number of columns on the screen. A sucessful 
will leave the cursor position unchanged and spaces 
from the cursor to the end of the line. 

Enter insert character mode. This mode allows the 
insertion of characters into a line the characters at 
the 80th column are lost. This mode is unaffected by 
the wrap around mode. If the cursor is on the 2Sth 
line the action is identical. 



Test: Three lines of text are printed on consecutive 
rows. The cursor is moved to some column on the mid- 
dle row. The Esc is executed and more than the 
number of columns on the screen are filled with £ 
character. A sucessful test will fill the line vith 
the character. If the wrap around mode is enabled, 
the test will cause the next line to be filled with 



25th line the «ction is identical. 



1 s on tr.r 



Esc z 1BH,7AH 



Test: the test is the same as above except that :-e 

Esc .D and Esc are executed alternately. A message 

will be output describing which mode is in a-f-fec: anti 
the results that should be observed. 

Nullifies all previously set escape modes and re^urn« 
to the power — up configuration. 

* special note: The Z19 de-fines the powei — up confirur — 
at ion as the mode set in the configuration switc-es 
S401 and S402. S401 sets the buad rate, parity, and 
duplex. S402 set the following. 



O=sunderscore cursor 

1 0=key click 

2 0=discard past 80th 

column 

3 0=no auto LF on CR 

4 0=no auto CR on LF 

5 0=Heath mode 

6 0=unshifted keypad 

7 0»60 Hz refresh 



l=block cursor 
l=no key click 
l=wrap around 

l=auto LF on CR 
l=auto CR on LF 
1=ANSI mode 
l=shifted keypad 
1=50 Hz screen refresh 



The Z19 clears the screen including to 25th line in 
this sequence. 

Sirius does not have a specification for the'powei — up 
condition. But, obviously the Heath escape mode is 
the default as is the 60 Hz screen refresh and mrst 
likely to unshifted keypad. Currently the curso- is 
block mode, no key click, wrap around, no auto L- on 
CR or CR on LF, the screen is cleared including ztie 
25th line. 



Esc X Cn3 1BH,78H 



Test: no test can be preformed until a specification 
for the defaults is defined. 

Certain operation modes can be enabled or disabled 
with this sequence. The operation modes are as 
follows. 



:> 



* 
* 



1 = Enable the 25th line. This allows the use o- the 
25th line. The cursor can be moved to the Sth 
line only with the Esc YC13Cc3 and the Esc k seq- 
uences. The 25th line acts like a 1 line 
terminal. All operations that are used on tre 24 
line screen operate on the 25th line. Howeva-, 
some of these operations will show no effect. 

3 = Hold Screen mode. 

4 = Block cursor on. 

5 = Display cursor off 
S = Auto LF on CR 

9 = Auto CR on LF 

A = Volume increase step 

B = Brightness increase step 

C = Contrast increase step 



« Note: supported by Sirius but not on Z19 

mode 2,6,7 not implemented on Sirius 



on the 25th 1 ine 

3 = E>!it Hold screen mode 

4 = Underline cursor 

5 - Display cursor on. 

8 = No Auto LF on CR 

9 = No Auto CR on LF 

* A = Volume decrease step 

* B = Brightness decrease step 
» C = Contrast decrease step 

Esc C 1BH,5AH Enter Hold Screen mode. The Hold screen mode allows 

the user to hold output to the screen. Keypress o-f 
the unshifted scroll will cause on line o-f text ^o be 
output to the screen. Keypress o-f the shifted scroll 
causes 24 lines to be output to the screen. Remrnber 
when the cursor is at the start o-f a line o-f te:;-:, 
the screen is probably waiting -for a scroll command. 
I-f the cursor is on the 25th line unshi-fted scroll 
should act identically. The shi-fted scroll should 
cause the 25th line to be replaced with the 24th 
received line of text after the keypress. 

Test; A message should be output explaining the 
effects of the test. Then text will be output tr the 
screen. The user will press the scroll key and cm- 
firm the action. The user will press the shiftet 
scroll and confirm the action. 

Esc \ 1BH,5CH Exits the Hold Scr»een Mode. -This nullifies the £bove 

Esc C sequence. 

Test! As above a message should be output. Then text 
should be output to the screen. The user will press 
the shifted and unshifted scroll key and confirm that 
they cause no action on the output. 

Esc p - -1BH,70H Enter reverse video mode. All characters are prirted 

in a reversed field. That is all characters are 
normally green on a black field, the reverse is rlack 
characters on a green field. This action is idert- 
ical on the 25th line. 

Test: Simply print part of a, message in normal crar — 
acters and part of the message in reverse video. A 
successful test will show reverse video and normsl 
video where the text describes. 

Esc q 1BH,71H Exit reverse video mode. This nullifies the Esc p 

sequence. This action is identical on the 25th line. 

Test: Same as above. 

Esc > 1BH,7DH Inhibits the output from the keyboard. 
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V 1BH,7BH A computer sent code to enable the keyboard afte- it 

has be disabled by the Esc > sequence. 

Test: A message is output describing that the ke— 
board is disabled. The user is asked to try any 
keypresses. The keyboard is reenabled and the key- 
board presses are echoed. A sucessful test will not 



It the chsrscter wss alre&dy on tne last row whe- tht 
attfeiTipt was made, the screen is scrolled and the 
character moved to column 1 of the last row on tr= 
screen. I-f the character to print past the end c- 
the line is on the 25th line, the line should be 
cleared and the character place in column 1. Ho»*- 
ever the Z19 does not clear the line but overwrites 
in column 1. 



Esc 



w 



1BH,77H 



Test: Simply print a line that is longer than the 
line lenght. A second line should be printed fron 
the last line o-f the screen to demonstrate the 
scrolling. A successful test will will show con- 
tinuation on the following line. 

Discard end of line. After the last column in a 
line the characters are overwritten in the last 
column of the line. If the cursor is on line 25, 
the action is identical. 



Test: Write a message that has more characters tf-an 
the line lenght. a successful test will print only 
one line while overwritting the last column of the 
line. 



A, cype videsign.doc 



Design notes on Vedio display 
and keyboard testing 



Cursor - The VT52 uses a blinking underscore. The Z19 uses a blinking 

box. The Sirius uses a nonbl inking box. The Sirius and Z19 car 
change the cursor type to several forms. 



Repeat 
key 



A> 



- The VT52 describes the rate of repetition may attain 30 cps but 
no futher characteristics are known. The Z19 describes the rate 
of repetition at 15 cps but no futher characters are are described. 
The Sirius repeat key will not start repetition for 1/2 second t-en 



-> 



purpose: 



132 COLUMN SPECIF JCA1 ION 



The 
display 
SIK'IUb' computer 



132 column mociule pirovides 3 simulated 132 column 
in the 800 dot by 400 line HIRtS display mode of the 



RESULT : 

The normal MT52 print interface recognizes an escape 
sequence to enable the 132 column mode. The characters are 
displayed in a 5 by 7 dot matrix in a 6 by 10 cell to give the 
132 column disptlsy. A standard display of SO columns by 25 lines 
is also simulated with an 8 by .11 dot matrix in a 10 by 16 cell. 

installation: 

The 132C program installs itself into the BIOS through a 
super BIOS call. The program requires approximately 50K of 
Memory. The 800 by 400 HIRES screen requires 40K,' the character 
sets and code are the rest. The 132c program copies itself into 
the lowest 64K bloc!', of memory and removes the 50K required bytes 
from the system permanently. 



J 32 Column Display Specification 
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CONTROL codes: 

BELL - CTRL G <07H> 

Generate 3 bell sound. Pess thru to VT52 

BACKSPACE - CTRL H <08H> 

Positions the cursor b3ck one column. If wrap around mode 
Is enabled and the cursor was at column 1, then position cursor 
at last column of previous row; unless at column 1, row 1 in 
which case posit ion to last column in row 1, If in discard mode, 
then the cursor will not move from column 1. 

HORIZONTAL TAB - CTRL I <09H) 

Positions cursor the cursor forward to the next tab stop. 
Tab stops ar^ fixed and ar& at columns 9, 17, 25, 33, 41, 49, 57, 
65, 73, 81, 89, 97, 105, 113, 121, and 129. If the cursor Is at 
the last column it remains there - 

LINE FEED - CTRL J (OAH> 

doves cursor to next line same horizontal piosition, scrolls 
the screen up If a line feed occures on the bottom line- If the 

cursor Is on bottom line + 1 then no action is taken. 

« 

RETURN - CTRL tt <ODH> 

Moves cursor to left most column of same line. 

SHIFT OUT - CTRL <OEH) 

Switch the character cell size to 6 by 10 resulting in a 
display of 133 columns by 40 lines. The top of screen will be set 
to line 1. and the bottom of screen will be set to line 39. The 
bottom line + 1 will be line 40 similar to yT52's 25th line. The 
cursor will home. 

SHIFT IN - CTRL N <0EH) 

Switch the character cell size to 10 by 16 resulting In 3 
display of 80 columns by 25 lines. The top of screen will be set 
to line 1 and the bottom of screen will be set to line 24. The 
cursor will home. 

CANCEL _ CTRL X <18H) 

Abort any Escap>e sequence in progress. Starts displaying 
characters as normal ASCII. 

h SCAPE - CTRL C (IBH) 

Start an escapee sequence. 
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ESCAPE SEQUENCES; 

TRANSMIT PAGE - ESC ♦» <1BH,23H) 

Will transmit only 3 RETURN <ODH) LINE FEED <OAH>. 

TRANSMIT CHARACTER AT CURSOR - ESC ♦ (1BH,2AH> 

Will transmit only 3 RETURN <ODH) LINE FEED <OAH>. 

SET HIGH INTENSITY - ESC < <1BH,28H) 

SimulBtes high intensity mode by shadow printing. 

SET LOW INTENSITY - ESC > <1BH,29H) 
Prints normal characters. 

ENTER UNDERLINE CHARACTER MODE - ESC (1BH,30H) 
Sets the underline mode. 

EXIT UNDERLINE CHARACTER MODE - ESC 1 <1BH,31H) 
Resets the underline mode. 

SET KEY VALUE - ESC 4Cn3Clk3Ckc3 <1BH,34H,XXH,XXH,XXH) 

Set I'^ey value. Five characters are passed thru to VT^^ to 
set new key values.' 

LITERAL CHARACTER - ESC 8 (1BH,38H) 

Display next character literally. 

hNTER INSERT CHARACTER MODE - ESC 6 <1BH,40H> ^ ^ * 

Enters insert character mode, allowing insert into text on 
the screen. As you type in new characters, existing text to the 
right of the cursor shifts to the right. As each new char3cter 
is inserted, the character at the end of the line is lost. 

CURSOR UP - ESC A <1BH,A1H> t* +w* 

Moves cursor up one line without changing columns. ^* y"® 
cursor reaches the top line, it remains there and no scrolling 
occurs. No action taken on bottom line + 1. 

CURSOR DOWN - ESC B <ieH,42H> 

Moves cursor down one line without changing columns. rne 
cursor will not move past the bottom line and no scrolling will 
take place. No action taken on bottom line +1. 

CURSOR FORWARD - ESC C <1BH,43H) tx- +in^ 

Moves cursor one character position to the right- it x-ne 
cursor is at the right end of the line, it will remain there. 
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ESCAPE sequences: 



CURSOR BACKWARD - ESC D <1BH,A4H) 

Moves the cursor one character position to the left, 
cursor is 3t the start (left end) of a line, it will 
there. 



If the 
refA3 i n 



CLEAR DISPLAY - ESC E <1BH,45H) 

Erase the screen from the defined top« line to the defined 
bottom line. If on bottom line + 1 the erases bottom line + 1 
on I (4. Places the cursor in the home p'osition. 

ENTER GRAPHICS MODE - ESC F <1BH,4AH) 

VT52 graphics characters appear In character numbers 94 to 
127 of the ASCII character set- 



EXIT GRAPHICS MODE - ESC 6 <1BH,47H) 

Normal lower case characters appear In character numbers 
to 127. 



74 



CURSOR HOME - ESC H <1BH,48H) 

Moves the cursor to the first character position 
defined top line. 



on the 



kEVERSE LINE FEED - ESC I <1BH,49H) 

Moves the cursor to the same horizontal position on the 
preceding line. If the cursor Is on the defined top screen line, 
a scroll down is performed. No action taken if on bottom line + 1, 

\ 
ERASE TO END OF PAGE - ESC J <1BH,4AH) 

Erases all the Information from the cursor (including the 

cursor position) to the end of the defined bottom line. If on 

bottom line -*■ 1 then erase to end of line only. 



ERASE TO END OF LINE - ESC K 

Erases from the cursor 
the end of the line. 



(1BH,4BH) 
( Including 



the cursor position) to 



INSERT LINE 

Inserts 
is on, 
bottom 



ESC L (1BH,4CH) 

a new blank line by moving the line that the cursor 
and all the following lines, down one line, to the defined 
line. Then the cursor is moved to the beginning of of the 



new blank line. No action taken If on bottom line + 1» 

DELETE LINE - ESC M (1BH,4DH) 

Deletes the contents of the line that the cursor Is on, 
places the cursor at the beginning of the line, moves all the 
following lines up one line, and adds a blank line at the defined 
bottom line. No action taken if on bottom line 4-1. 
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ESCAPE SEQUENCES: 

DELETE CHARACTER - ESC N <1BH,4EH) 

Deletes the character at the cursor piosition and shifts any 
existing text that is to the right of the cursor one character 
position to the left. 

EXIT INSERT CHARACTER MODE - ESC <ieH,4FH) 
Exits from insert character mode. 

DIRECT CURSOR ADDRESSING - ESC YCl«3Cc»3 ( 1BH,59H,XXH,XXH) 

Moves the cursor to a p«osition on the screen by entering the 
escapie code, the character which repiresents the line number, and 
the character which represents the column number. The '1ft' 
represents the hexadecimal line number and 'eft' represents the 
hexadecimal column number. The first line and the left column 
ar^ both 20 (hex) (the smallest value of the p'rinting characters) 
and increase from there. Since the lines are numbered from 1 up 
(from top to bottom) and the columns from 1 up (from left to 
right), You must add the p^roper line and column numbers to IF 
(hex). If the line number entered is smaller than the defined 
top line, the cursor will be piositioned to the 
IJne number entered is greater than the defined 
the cursor- will not more from it piresent line, 
number is too high, the cursor will move to the 



top I ine. If the 
bottom I i ne -4- 1 , 
If the column 
end of the line. 



IDENTIFY AS VT52 - ESC Z (1BH,5AH) 

CONIN responds with "ESC/K" to indicate that it can perform 



as VT52. 



\ 



TRANSMIT BOTTOM LINE - ESC 3 (1BH,5DH) 

Will transmit only a RETURN (ODH) LINE FEED (OAH) . 

TOGGLE DEBUG MODE - ESC _ (1BH,5FH) 

Toggles debug mode on or off. In debug mode the bottom line 
+ 1 displays the hex codes for print stream. 

ERASE BEGINNING OF DISPLAY - ESC b (1BH,62H) 

Erases from the start of the screen to the cursor, and 
includes the cursor piosition. 

REVERSE TAB - ESC h (1BH,68H) 

Moves cursor left to next mod 8 position. Stops on left 
side of screen. 
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ESCAPE SEQUENCES: 

SAVE CURSOR POSITION - ESC j (1BH,6AH> 

The present cursor position is saved so the cursor can be 
returned here later when given the set cursor to saved position 
command. 

SET CURSOR TO SAVED POSITION - ESC k <1BH,6BH) 

Returns the cursor to the F«osition where it was when It 
recleved the save cursor position command. If the line number 
restored is smaller than the defined top line, the cursor will be 
positioned to the top line. If the line number restored Is 
greater than the defined bottom line + 1, the cursor will not 
more from it present line. If the column number is too high, the 
cursor will move to the end of the llne- 

tRASE ENTIRE LINE ~ ESC I <1BH,6CH) 

Erases all the line including the cursor position. 

SET SIZE - ESC mCclDCc23Cc33 <1BH,6DH,XXH,XXH,XXH, > 

If cl Is ASCII "1" then set cell width and height. Th^ c2 
character equals width+lFH and the c3 character equals 
height+lFH. Width and heigth can range from 1 to 16. The 
Maximum number of of character columns and lines are determined 
by: max columns = 800/width, max lines = 4l30/height. After set 
cell size the topi line is set to 1 and the bottom line is set to 
max lines - 1. The cursor will home after the cell size Is set. 

If cl is ASCII "2" then set screen top and bottom. The c2 
character equals top Ilne+IFH and the c3 character equals bottom 
line+lFH. Top line and bottom line can range from 1 to max lines 
with bottom line always greater than or equal to top line. The 
cursor will home after the screen size is set. 

CURSOR POSITION REPORT - ESC n <1BH,6EH,XXH,XXH) 

CONIN rep'orts the cursor piosition in the form of ESC Y linett 
columnH. 

ERASE BEGINNING OF LINE - ESC o <1BH,6FH) 

Erases from the beginning of the line to the cursor, and 
includes the cursor position. 

ENTER REVERSE VIDEO MODE - ESC p <1BH,70H> 

Enters the reverse video mode so that characters are 
displayed as black characters on a white background. 

hXIT REVERSE VIDEO MODE - ESC q <iBH,71H) 
Exits the reverse video mode. 
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*^ SCAPE SeaUfNCES: 

WKAP AROUND AT END OF Ll,n . .SC v <1BH 7Am 
A print to th** la«i4 ^^ , ^ ^ <1BH,76H) 

cursor plsltln^nToltrl^^l"':" "^ ^''^ ^'^ "'l' "ot change 
Isst character recelC^"^ Ct ?V^"''*?- Therefore, only 
position. reived will he drsplayed in the Ust col 

"" "sets'the" "fir„r^' <«.^78H,XXH> 

^ = Block cursor 
5 = Cursor off 

9 : Auto cR":„';:e^rot "%";?' °^ ^'■^ 

A » Send to 5?52 '^* °^ ^'"^ ^^"^^ 
8 = Send to VTtJ2 
i' = Send to VI52 

S : Cu"r::;"r '""°" *■"' '^ ^^ar^cter height > 9, 

^ * No 3uto line feed 

9 = No auto CR ' 

A « Send to VT52 

B = Send to VT52 

<• * Send to V1I52 

ktSEl 10 POWER-UP C0NFI(4URATT/iw c^r. 

R«et back to 8o'colu«n":ode".''' ' "'"'"•^"' 

KEVBOARD ENABLED - ESC < <1BH,7BH) 

-i-ble co^and'" Pasf ?hru ^rOtsa! "" ""^""ted hg a Keyboard 

ENABLE 132 COLUMN DISPLAY - ESC I <1BH 7cm 
Enable 132 column «ode. <1BH,7CII) 

"^''^''Jnhib^f ^Vk ■ ^'''= ^ <1BH,7DH> 

inh.b.ts the output of the Keyboard. Pass thru to .T52. 
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PORT CONFIGURATION USER GUIDE 



The Port Configuration utility provides for the modification 
of the serial and parallel ports' device assignment and/or 



attributes. 



INTRODUCTION 



The Port Configuration program provides the capability to 
change communications and printer device assignments (and/or 
associated attributes) after the Victor 9000 is booted up and 
set to its Sys Gen states. The Sys Gen parameters for the 
two serial and the one parallel port may be modified while the 
system is up and without resorting to a complete Sys Gen process 
For example, this utility allows for easy toggling between a 
connected serial and parallel printer. 

It is required that the system diskette .be loaded la one of the 
drives. The Port Configuration utility may be invoked to 
modify or restore the port assignments and attributes. 

Rebooting or off/on cycling of the computer restores the system 
to the original Sys Gen assignments. 



G 



I • 



INVOKING PORT CONFIGURATION 
(PQRTCONF) 

To invoke PORTCONF. enter the following input from the keyboard 
from the Operating System prompt. 

PORTCONF . 

Screen Response: 



vTrroR 9000 rnMmiNICATin w mNFIGURATION PROGRAM 

SELECT 

1. Port A (RS-232) 

2. Centronics/Parallel 

3. Port B (RS-232) 

To select a listing device enter a number from menu: 



If 1 or 3 above is selected, the following menu occurs 



COMMONLY USE! 


) TRANSMISSION SPEEDS 




BAUD RATES 


A. 


50 


B. 


75 


C. 


110 


D. 


134.5 


E. 


150 


F. 


300 


G. 


600 


E. 


1200 


I. 


1800 


J. 


2000 


K. 


2400 


L. 


3600 


M. 


4800 


N. 


9600 


To set transmission speed enter a letter from menu: 



o 



Return to the Operating System is automatic. 
If NO. 2 is selected from the -ain menu (Centronics/Paral^ 
the system is set to drive a parallel printer. Return to 
Operating System is automatic. 



ChBrscter S>et Editor - User Notes 



Introduction 



CEDIT is en interim ptroQrsm, between EDOT snd the new 
cliaracter editor, which is used to edit or create character 
set tables. 



Files 



You Must have the following files to run CEDIT s 



ALLOC. CMD 
PBASIC86.CMD 
CEDIT.BAS 
« . CHR 
CHARGEN.SUB 



Machine language interface. 

Microsoft run-time BASIC interpreter. 

The edit program. 

The character set files. 

Submit file, opttional. 



Invok ing 

To run CEDIT do either? 

A>SUBMIT CHARGENCcr) 



or 



A>ALLOC<cr> 
A>FBASIC86 CEDIT(cr) 



CEDIT must be run on a system configured with a logo 
character set. 

It then prompts you for the source character set files to be 
collected snd edited (appear on the right-half of the 
screen). Enter the file names <.CHR is default) followed by 
a <cr). After the last one, enter "END". 

You ares then prompted for one more character set. This is 
the one which is to be modified and then written out. It 
appears on the left-half of the screen. 

After this character set is read, all the character sets aret 
displayed and the program is in "COPY" mode. 



CEDIT Modes 
COPY 



DISPLAY 
EDIT 



Cop'ies characters from the right-half of the 
screen to the left-half. It replaces the character 
under the left cursor by the character under the 
right cursor. 

Disp'lays the dot pattern of the character under 
the right cursor. 

Allows changes to the dot F«attern of a character. 
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Using CtDIT 



D 



In all modes, the number 7, 8, 9, 4, 6, 1, 2, 3 keys are 
used to move the cursor. The direction of the movement is 
ilustrated by this discirBm, where the cursor Is at the X and 
the movement Is in the direction of the number pressed: 

7 8 9 

12 3 

The number 5 key causes different actions, depending on the 
mode. In the COPY mode, it causes a character copiy; in the 
DISPLAY mode, It enters the EDIT mode; and In the EDIT mode, 
it inverts the current dot. 

COPY mode commands: 

R Activate right cursor only. 

L Activate left cursor only. 

B Activate both cursors. 

E Enter DISPLAY mode. 

U Write left character set. 

DISPLAY mode commands: 

Only the number keys sr^ used in DISPLAY mode. However, 
any of the COPY mode commands, except E, return the 
program to the COPY mode and Is performed. 

EDIT mode commands: 

These commands are: the same as the old EDOT commands. 

E or P Position only mode. 

1 Toggle mode. 

S Set mode. 

R Reset mode. 

C Clear character. 

<cr) Return to DISPLAY mode. 



Saving the Character Set 

In either COPY or DISPLAY mode type a "W". This command 
writes the left character set to the designated file. 

You sr€! prompted for a file name, if you respond with just a 
(cr) then the name of the inp'Ut file is used. You sr^si then 
prompited for any changes to the header record. 

For now, 256 characters are always written, regardless of 
the set size. 
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CREATING AND EDITING CHARACTERS 
UNDER OPERATING SYSTEM 2.1 

USER'S GUIDE 

INTRODUCTION 

CEDIT is used to create new character sets from existing ones. 
It also includes the ability to create new characters by editing 
the dot configuration of old characters. By clearing existing 
characters, new characters can be created from scratch. 

FILES 

You must have the following files to run CEDIT: 

^c?So?^ Machine language interface 

BASIC86.CMD Microsoft basic 

CEDIT. HAS The edit program 

•CHR Character set files 

CEDIT MODES 

^2^ Description 

^°P^ Copies characters from right-half of 

screen to left-half - substitute the 
character under the right cursor to 
position under left cursor. 

Changes dot configuration of character. 

DISPLAY Displays the character that is under 

the cursor on the right -half . The 
display appears on the left-half in bit 
cell detail, 

fp^arslrSe^elt-ha?!^"" °" *''" -^^^^-^-^^^ -w or edited set 

INVOKING 

Type the following: 

A> ALLOC (cr) 
A>BASIC86 CEDIT(cr) 

anH^'oi^^-^S^/ prompt you for source character" set names to be coller-ed 
cans wi^^n, 5^^^^^""! on the right -ha If of screen). Enter the names £n 
aS^^ i' V ^ extension (.CHR assumed) followed by a carriage re=Lm 
^arLter s^t *'"^' ^"'''^'' ^^' ^°^ ^^^ ^^ prompted for one lore 



Tu.-. -•.= 1-hP one vou will modify and then write out (save). This 
^^^ «^%Spl^ft -half of screen. When this is done, the character 
f^?r^U a^'^be'displayed^Lry^u will be in the ••COPY" mode with no 
cursors displayed and no control functions enabled. 

USING CEDIT 

In all modes, the number keys move the cursor as indicated in 
this diagram: 

7 8 9 

The "5" key copies the character from under the right cursor 
^ under the left one in COPY mode, enters EDIT mode^when xn 
MsSlAY mode, and inverts the current dot xn EDIT mode. 

Here are the commands in COPY mode: 

R - use right cursor 
L - use left cursor 
B - use both cursors 
E - enter DISPLAY mode 
W - write character set 

Tn DISPLAY mode the cursor keys work on the righf-hand cursor 

lo sele^ the displayed characters. The same commands ^^^/;;;^^^^^- 

only "E" hasno effect and the others take you back to COPY mode. 

EDIT mode is the same as the old EDOT with the following commands : 

E or P - position only mode 

T - toggle mode 

S - set mode 

R - reset mode 

C - clear character to all off 

(CR) - exit to display mode 

.. When you are done and ««dy to save the character ^-^^^^l^^'^^ 
command. You will, agaxn, be prompted tor a xxxe "f"Xl-! ^^en with 

-s^LS feL^r-T^i^ "ecorTwi^rs^r/ J^^^^^ 

'.tr^^. i58^chtrSrSe^:^ittSVeI^^a?Lf ^f'-lc^Srset size. 



o 
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